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APPLE COMPUTER INC. MAKES NO WARRANTIES, EITHER EXPRESS OR IMPLIED, 
WITH RESPECT TO THIS MANUAL OR WITH RESPECT TO THE SOFTWARE DESCRIBED 
IN THIS MANUAL, ITS QUALITY, PERFORMANCE, MERCHANTABILITY, OR FITNESS 
FOR ANY PARTICULAR PURPOSE. APPLE COMPUTER INC. SOFTWARE IS SOLD OR 
LICENSED "AS IS". THE ENTIRE RISK AS TO ITS QUALITY AND PERFORMANCE IS 
WITH THE BUYER. SHOULD THE PROGRAMS PROVE DEFECTIVE FOLLOWING THEIR 
PURCHASE, THE BUYER (AND NOT APPLE COMPUTER INC., ITS DISTRIBUTOR, OR 
ITS RETAILER) ASSUMES THE ENTIRE COST OF ALL NECESSARY SERVICING, 
REPAIR, OR CORRECTION AND ANY INCIDENTAL OR CONSEQUENTIAL DAMAGES. IN 
NO EVENT WILL APPLE COMPUTER INC. BE LIABLE FOR DIRECT, INDIRECT, 


INCIDENTAL, OR CONSEQUENTIAL DAMAGES RESULTING FROM ANY DEFECT IN THE 
SOFTWARE, EVEN IF APPLE COMPUTER INC. HAS BEEN ADVISED OF THE 


POSSIBILITY OF SUCH DAMAGES. SOME STATES DO NOT ALLOW THE EXCLUSION OR 


LIMITATION OF IMPLIED WARRANTIES OR LIABILITY FOR INCIDENTAL OR 
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Function Hex +WDec —Dec 


Load SDC (\) into A-reg. 


FD62 64866 -679 CANCEL A,X,Y 
Backward slash indicates line 
input cancelled. & 
Call COUT to print A-reg. FD64 64868 -668 
Then fall into GETLNZ. & 
Print carriage return thru COUT. & FD67 64871 -665 GETLNZ A,X,Y 
Load PROMPT into A-reg. & FD6A 64874 -662 GETLN A,X,Y 
Call COUT to print A-reg. & FD6C 64876 -66¢ 
Load X-reg with $91 for passage FD6F 64879 -657 A,X 
thru backspace operation. 
If X=$ goto GETLNZ to start over. FD71 64881 -655 BCKSPC A,X,Y 


Else, decrement X-reg and 
fall into NXTCHAR. 
Call RDCHAR to get next character. FD75 64885 -651 NXTCHAR A 
If character received is ctr1-U 

($95, right arrow) pick up the 

screen character from (BASL) ,Y 


to replace it in the A-reg. & 
If A-reg greater than $DF, then FD7E 64894 -642 CAPTST 2A 
AND against SDF to make it 

upper case. & 


Store A-reg to input area at IN,X. FD84 64999 -636 ADDINP 
Compare to carriage return. 

Goto NOTCR (above) if not. 

Else, call CLREOL to clear the 

rest of the line, then print 

carriage return thru COUT, 

using RTS from that function to 


accomplish return to caller of 
keyboard input. 


=$0299, keyboard input area. 


INVFLG is at $32 (59). 


OVERVIEW—TEXT OUTPUT TO THE SCREEN 
ET TU TE SCREEN 


The highest level of support in the Monit 
Screen is scroll device support. 
many components which support use 
Because there are so many ways to 
of screen output has been divided 


or for text output to the 

In addition, the Monitor contains 

of the screen in a formatted manner. 
write text to the screen, the topic 
into the following sections: 


TEXT OUTPUT WITHIN THE SCROLL WINDOW 
describes the normal manner of text output, 


Page zero which are used to control this fun 
used in the descriptions in the following se 


defining the fields in 


ction, and which are 
ctions. 
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SCREEN FORMAT CONTROL 


identifies the entry points by means of which display operation 
(full text, full graphics, mixed LORES graphics and text), Scroll 
Window setup, and character display mod 


e (black on white or white 
on black or blinking) are established or modified, 


SCROLL WINDOW DATA MANIPULATIONS 


er specified value, or 
ng of the window. 


CURSOR POSITION CONTROL 


describes the ways and means of movin 
current position, 
current position. 


8 the cursor relative to its 
or moving it to some location independent of its 


GENERAL TEXT TO THE SCREEN 


describes the Monitor entry points to output user program 
generated data to the scr 


een or to the current output device if 
CSWL has been modified. Also, entry points are described to 
transmit standard types o 


f output (blanks, bell code, carriage 
return) to the output device (generally screen). 


TEXT OUTPUT WITHOUT THE SCROLL WINDOW 


describes the entry points used for 
screen outside of the 


when echo to the Scrol 


Placing characters on the 
Scroll Window, and for reading the keyboard 
1 Window is to be performed. 


SECONDARY DISPLAY AREAS 


Any entry point which fits into more than one category will be found 
in each appropriate address table. 


OUTPUT WITHIN THE SCROLL WINDOW 
RULE WINDOW 


Scroll Window operation is com 
Output in that new chara 
output, and new lines ar 
mode of operation which 

section describes "printing" 


patible with printer or typewriter 
cters are dis 


It is this 
That is, this 
information by means of the CSWL vector 


The section on General Text 
the screen, bypassing the CSWL vector 
and making direct use of the Scroll Window output routines. 

The normal method provided in the A 


information is by "calling" COUT with the char. 
each displayable character or format control ¢ 
carriage return). At COUT 


to the routine which will 
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REGISTERS FOR BASIC MONITOR CALLS 


Many of the entry points specified in this book require presetting of 


registers for proper operation. Following is a sample eee tae 
written for APPLESOFT, which uses Monitor calls for conversion from 


decimal to hex. 


The theory behind the operation is that on a Monitor G command, the 
registers are loaded from the SAVE area before going to the location 
specified in PCL,H. Thus, by poking destination address into PCL,H 
and the required register contents into XREG, YREG, an entry point in 
the Monitor Go command processor can be used to pass the registers to 
4 selected routine. 


DECIMAL TO HEX CONVERSION 
APPLESOFT SAMPLE PROGRAM 


1g REM CONVERT DECIMAL INPUT TO HEX OUTPUT 
190 INPUT "ENTER NUMBER Mas Read the input. 
119 IF A=99999 THEN END Provide a way to end the program. 
159 C% =A / 256 Isolate the high byte. 
200 POKE 71,C% Set YREG for PRNTYX call. 
300 BX =A / 256 Get remainder from A/256. 
319 B=B% * 256 For low byte (XREG) POKE. 
329 BX =A-B 
359 POKE 70, B% 
409 POKE 59, 249 
500 POKE 58, 64 
559 PRINT 
699 CALL 65299 
659 PRINT 
799 GoTo 199 


STEP AND TRACE PECULIARITIES 


The Step and Trace functions in the Old Monitor incorrectly display 
register contents under some circumstances. The STEP routine detects 
and gives special attention to JSR, RTS, JMP, JMP indirect, RTI, and 
BRK instructions. In each case, the register contents are displayed 
from the SAVE area at $45-49, However, there is no SAVE call after 


"execution" 


Set PCH to $F9. 
Set PCL to $4g. 


Print a blank line. 
Entry point in GO processor is FEB9, 


Print a blank line. 
Go around for another number. 


are those present in the 
VE area before execution of this instruction. 


Therefore, on JSR and RTS, the displayed contents of the S-reg are 


incorrect. On the first instruction after a JSR or RTS, the S-reg 
displays correctly, unless that also is an RTS or JSR. 
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utines are not incorrect in handling of a BRK 


instruction. That is, the address displayed for the BRK is correct, 
instead of being off by two bytes, because the BRK is detected by the 


STEP routine instead of being executed by the 6592. 


The Step and Trace ror 


Although step and trace can be very helpful for some program 
debugging tasks, they cannot be used in tracing calls to the Monitor 
(generally including "print" output) or for programs which use AIL,H 
thru A4L,H. 


Because of the lack of "CLD" at PCADJ ($F953), incorrect addresses 
will be displayed if you set decimal mode (SED) within the program 


being traced or stepped. 
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